home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / uhren & terminkalender / time / aboutclock / aboutclock.doc < prev    next >
Text File  |  1996-04-07  |  12KB  |  290 lines
  1. *****************************************************************
  2.  
  3.                         AboutClock V3.00
  4.  
  5.                    Copyright 1993 Stuart Davis
  6.                        All Rights Reserved
  7.  
  8. *****************************************************************
  9.  
  10. Contents
  11.                            Distribution
  12.                            Description
  13.                            Usage
  14.                            Development
  15.                            Author Details
  16.  
  17. -----------------------------------------------------------------
  18.  
  19. Distribution
  20.  
  21.      AboutClock  V3.00 is Shareware  and  NOT  Public Domain, and
  22. as  such  a  small  registration  fee  of 5  pounds  sterling  is
  23. required  if  you  decide  that  AboutClock V3.00  should  be  in
  24. your software collection. This will entitle  you to  a  disk with
  25. a collection  of otherwise  unobtainable programs  by me  and the
  26. next major upgrade.
  27.  
  28.      Payment should be in the form of a crossed cheque drawn from
  29. a UK mainland bank payable to the author.
  30.  
  31.      The  distribution  of   AboutClock  V3.00  MUST  be  intact,
  32. unaltered, and include the following files :
  33.  
  34.                     AboutClock
  35.                     AboutClock.info
  36.                     AboutClock.doc
  37.  
  38. -----------------------------------------------------------------
  39.  
  40. Description
  41.  
  42.      Do you remember the good old days when you asked someone the
  43. time and they  said, "It's nearly five" and not "It's 4:57 and 28
  44. seconds" ?
  45.  
  46.      Well now there is a Workbench clock that does just that! 
  47.  
  48.      AboutClock  V3.00  is  an  unobtrusive  clock  that  nestles
  49. neatly at the top  of Workbench, telling  the time  in words in a
  50. window  that  re-sizes  itself  to  account  for  the  length  of
  51. message required. It is now  able to tell the time in a number of
  52. different European languages thanks to the efforts of Daniel Amor
  53. who provided the idea and translations.
  54.  
  55.      Also,  for short-sighted Amiga users, there is the option to
  56. have AboutClock V3.00 speak the time!
  57.  
  58.      Not  only  is  AboutClock V3.00  simple  and functional, but
  59. it is compatible with all versions of Workbench!
  60.  
  61. -----------------------------------------------------------------
  62.  
  63. Usage - CLI/startup-sequence
  64.  
  65.      type "run" like this to run the program in the background:
  66.      
  67.      run <nil: >nil: path:AboutClock
  68.      
  69.      To enable  AboutClock  to  read  it's  preferences, the icon
  70.      must be present in the  same  directory as the main program.
  71.  
  72.  
  73. Usage - WorkBench
  74.       
  75.      Double click the icon. That's all there is to it.
  76.      
  77.  
  78.      AboutClock  V3.00  will by default appear  in  the  top left
  79. corner of the Workbench screen.
  80.  
  81.      AboutClock  V3.00  has  three  menus,  Project,  Speech  and
  82. Language.
  83.  
  84.      The Project menu gives  the options of ABOUT and QUIT, which
  85. give details of the author, and quit the  program respectively.
  86.  
  87.      The  Speech  menu  has TIME?... and  SPEECH. Selecting Time?
  88. will  make  AboutClock V3.00 tell you the current time, using the
  89. Amiga's incredible  built in speech  facility, where as selecting
  90. Speech will force  AboutClock V3.00 to tell you the time whenever
  91. it changes. This will be indicated  by a tick next to the option.
  92.  
  93.      In order to use  the speech option,  it is required that the
  94. following files are present on your Amiga setup:
  95.  
  96.     DEVS:narrator.device
  97.          audio.device (WB1.2/1.3 only.)
  98.             
  99.     LIBS:translator.library
  100.          icon.library
  101.       
  102. If the program fails to  find  these  files it won't allow speech
  103. after telling you the problem. WB2.x users will find all but 1 of
  104. these files on their  original  WB  disks. The audio.device is in
  105. the ROM for these machines.
  106.  
  107.    * WB3.0 users note :- Commodore have  deemed in their infinite
  108.                          strangeness  not  to  include  the files
  109.                          narrator.device  and  translator.library
  110.                          on the  WB disks!?  Why?  Well I suppose
  111.                          that they decided  they  have power over
  112.                          the Amiga voice  and  wanted  to silence
  113.                          it. (Ahhh...shame on you CBM!)
  114.                          So I have therefore started the anti-CBM
  115.                          RAVe motion, (Return the Amiga's VoicE).
  116.                          This is to persuade  the big C to return
  117.                          the lost library and device files to the
  118.                          poor deprived WB3  users  who have never
  119.                          heard sexy!?!? Paula speak.
  120.                          If you are a  WB3  owner  then the files
  121.                          will work on  your  machine  and all you
  122.                          have to do is get  them from a friend or
  123.                          a PD library. Then you can hear Paula in
  124.                          her proudest moment!(PC owners suck...!)
  125.  
  126.      The Language menu is  used to  select the  language you want
  127. time to be displayed  in.  It consists  of  a number  of mutually
  128. exclusive menu items  each with  their own  keyboard shortcut. By
  129. selecting one of these languages, AboutClock will change the text
  130. used for the  menus and  the time  text. I  am not  multi-lingual
  131. myself and so  if you  see any  blatant  errors or silly mistakes
  132. then let me know and  I'll fix  them. Also, if  you would like to
  133. see your own  language or  any other  featured then  write  to me
  134. regarding the translation & we'll see about getting it included.
  135.  
  136.                             *****************
  137. I would be particularly interested in hearing from Scottish,Welsh
  138. or Irish speaking people  about doing  the translations for these
  139. languages - please write to me !!!!!!!!!!!!
  140.                             *****************
  141.  
  142. -----------------------------------------------------------------
  143.  
  144. Icon Tool Types
  145.  
  146.      AboutClock now checks it's icon for the following recognised
  147. tool types:
  148.  
  149.         POSX=x        This can be set  to  any number but for the
  150.                       program to open its window, the coords must
  151.                       reside somewhere within the screen.
  152.                       Default=0
  153.  
  154.         POSY=y        Ditto..
  155.  
  156.         SPEECH=ON|OFF An "ON" or "on"  will  turn on regular time
  157.                       updates  whenever  the  time  changes.  Any
  158.                       other string value will be ignored.
  159.  
  160.      
  161. -----------------------------------------------------------------
  162.  
  163. Development
  164.  
  165. V1.00 31-12-92
  166.      My own very  personal  and non-PD  version. Ooo-err missus?!
  167. This is my very  first  attempt at  programming  a utility on the
  168. Amiga and it shows! It works fine on my machine but not on anyone
  169. elses!?
  170.  
  171. V1.12
  172.      Some  errors  related to  telling the  time occur at certain
  173. times  of the day.  When  AboutClock  resizes  itself, all active
  174. processes receiving user input on Workbench are  resized, notably
  175. ED  and  SID V1.06, when used under Workbench 1.3 which can prove
  176. to be annoying, but not dangerous.
  177.      This version NOT released to the public.
  178.  
  179. V1.14
  180.      Tells the correct time without errors.  About and Quit menus
  181. added.  Opens too  large  a  window, and crashes the machine when
  182. About is selected,  under  Workbench 1.3.  No  problems noted for
  183. Workbench 2 and above.
  184.      This version released  prior to testing on Workbench 1.3 and
  185. distributed on Amiga User International's April'93 issue.
  186.  
  187. V1.14b
  188.      Window  size  corrected,   and  selecting  About  no  longer
  189. crashes  the machine,  but  text  is  not  visible   (applies  to
  190. Workbench 1.3 only).
  191.  
  192. V1.15
  193.      About  text  is  now  visible.  Error corrected in  telling,
  194. the time around 9am which was detected in V1.14b.
  195.      This version released on Amiga Computing's April'93 issue in
  196. which they reported that it was written in Pascal! Open your eyes
  197. guys  - since  when  have 'move.w 12(a0,d2.l),d3' or 'bmi.s' been
  198. Pascal commands?
  199.  
  200. V1.16
  201.      About requester may be selected as often as you wish with no
  202. delay in updating it. Another error corrected in telling the time
  203. which was detected around 6pm.
  204.  
  205. V2.00
  206.      AboutClock is alive! Version 2.00 includes speech. Also, the
  207. about  requestor  has  been  improved.  It also  works on WB3 but
  208. requires a copy of a narrator.device to be in the Devs directory,
  209. which is not supplied with WB3.
  210.  
  211. V2.01
  212.      Another attempt was made to get the icon tool types to work.
  213. I can do this from 'C' but in assembler I just can't get the hang
  214. of it!? It will now work so long as  you run the program from the
  215. CLI and from  the same  directory as  AboutClock. I will probably
  216. fix it properly soon.
  217.  
  218. V2.02 16-7-93
  219.      After getting bored with some other programming I was doing,
  220. I decided to fix the  problem  of  window  width for non-standard
  221. fonts on Workbench  which WB2.04  and better machines can use. It
  222. only worked before  if WB was  using  topaz-8 font. This has been
  223. solved now and will resize correctly whatever font is used.
  224.  
  225. V3.00 31-8-93
  226.      Major revision  here to  include  different languages.  Many
  227. thanks go out to my friend  Daniel Amor in Stuttgart for the idea
  228. and doing the translations.
  229.  
  230. -----------------------------------------------------------------
  231.  
  232.      AboutClock V3.00 was  developed  on  a  HiQ Tower containing
  233. an  Amiga 500  Plus,  4Mb  of  16 Bit Fast RAM, 2Mb Chip RAM, SSL
  234. 68020 Accelerator Board with 4Mb  of 32 Bit Fast RAM,twin 3½ inch
  235. disk drives, a 5¼ inch  disk drive, a 105 Mb, 11ms  Quantum  hard
  236. disc drive, a Citizen Swift 24C printer, two Zipstick  joysticks,
  237. a Technosound Turbo sampler, a Naksha Mouse and a ProGen Genlock.
  238. It was  written in  100% assembler  using the  most excellent and
  239. bodacious HiSoft Devpac V3.04.
  240.  
  241.      For Workbench  1.3  compatibility, it was tested on an Amiga
  242. 500 with 4.5Mb 16 bit Fast RAM  and 0.5Mb  Chip RAM switchable to
  243. 4Mb 16 bit Fast RAM and  1Mb Chip  RAM(dodgy connection though!),
  244. twin 3.5 inch disk drives,  42Mb  GVP hard disc drive,  SSL 68020
  245. Accelerator Board with  1Mb of 32  bit Fast RAM  and a 68881 FPU,
  246. a KCS PC Emulator and an Argos screen filter(well it looks nice).
  247.  
  248.      For  Workbench 3  compatibility, it was tested on  an  Amiga
  249. 1200,  2Mb Chip RAM,  4Mb Fast RAM, 68881 FPU, twin 3.5 inch disk
  250. drives, and a 60Mb hard disc drive. (not any more though Mel eh!)
  251. and Danny's Amiga 4000.
  252.  
  253.      Although  not  every  possible configuration of hardware has
  254. been  tested, (send me an A4000T and I will test AboutClock V3.00
  255. on it!), it  is  extremely  unlikely  that  AboutClock V3.00 will
  256. not work on your machine.
  257.  
  258.      Please report  any errors / problems  to the author when you
  259. register your copy of AboutClock.
  260.  
  261.      [ If you don't register, you can't moan ]
  262.  
  263.      Thanks  go  to  Howard  Manwaring  BEd  MSc  MBCS  CEng  and
  264. Liz Warriner BMus Dip  Microprocessors  & Prod Des  of West Herts
  265. College for assistance with  the  debugging of the original code,
  266. Melville Carrie for  support and for the use  of  his Amiga 1200,
  267. and Colin(gorgeous sister)Etwell for the icon,  documentation and
  268. beta testing on his 1.3 Amiga 500(revision 1.0aß motherboard with
  269. V2.04 Rom from Ron-ha! it's out now!!).
  270.      BTW-Thanks again to Daniel Amor(when's the 24-bit version of
  271.                                       Clouds coming out?!)
  272.  
  273. -----------------------------------------------------------------
  274.  
  275. Author Details - that's me
  276.  
  277.      Stuart(Abdu) Davis, (nickname from Djamodiline Abdoujaparov-
  278.      132 Rempstone Road,   the blinding Tashkent cycle sprinter!)
  279.      Merley,
  280.      Wimborne,
  281.      Dorset,
  282.      BH21 1SX
  283.                                 //
  284.      England                  \X/ PC's are crap,
  285.                                     Archimedes are amoebas,
  286.                                       There's only one choice,
  287.                                         And that's the Amiga...
  288.  
  289. *****************************************************************
  290.